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I.  INTRODUCTION 


The  PCVUGRAF2  program  la  an  Improved  version  of  the  earlier  PCVUGRAF  pro¬ 
gram  (MI COM  Technical  Report  TR-RD-DE-86-1 ) .  The  PCVUGRAF2  program  Is  written 
In  PASCAL;  Turbo-Pascal,  Borland  International,  and  no  longer  requires  the 
third  party  graphics  library  GRAPHMATICS.  This  language  change  provides  a 
transportable  code  without  the  requirement  placed  on  the  user  to  supply  any 
additional  library  routines.  Additionally  the  code  facilities  have  been  en¬ 
hanced  to  provide  a  better  user  interface  and  take  advantage  of  the  newer 
Hewlett-Packard  plotters  that  provide  automatic  page  feed. 

II.  BACKGROUND 

The  PCVUGRAF2  program  was  developed  within  the  MI COM  Directed  Energy 
Directorate  as  an  expedient  tool  for  the  creation  of  presentation  quality  text 
charts.  The  philosophy  that  drove  the  code  developawnt  was  that  the  tool 
should  be  compatible  with  a  minimal  microcomputer  system,  not  require  exces¬ 
sive  computer  background  or  knowledge,  allow  for  the  storage  of  the  chart  In¬ 
formation  on  disk,  and  provide  sufficient  options  to  allow  a  reasonable  vari¬ 
ety  of  chart  types  at  a  presentation  quality  level.  Presentetlon  quality 
level  Is  defined  as  a  graphic  arts  quality  at  least  that  of  typewriter  gene¬ 
rated  charts  but  not  necessarily  of  the  professional  quality  of  a  graphic  arts 
department.  The  approach  was  to  develop  the  code  In  TURBO-PASCAL  on  a  micro¬ 
computer  equipped  with  a  Hewlett-Packard  pen  plotter.  A  number  of  Hewlett- 
Packard  pen  plotters  are  available;  the  model  7550a  is  used  in  this  discussion 
as  typical  of  these  plotters,  compatible  with  most  microcomputers  and  having 
exploitable  bullt-ln  features  that  would  facilitate  and  simplify  the  program 
development . 

Alternate  approaches  to  the  code  development  were  considered  but  finally 
narrowed  to  two.  One  approach  would  be  that  of  a  design  that  would  be  verv 
user  friendly  In  which  It  would  be  assumed  the  user  would  have  little  or  no 
knowledge  of  a  computer.  The  code  In  this  case  would  be  required  to  "ask 
questions"  of  the  user,  process  the  Information,  store  the  data  on  file,  and 
finally  plot  the  resulting  chart  as  the  built  In  logic  would  dictate.  From 
experience  It  was  found  that  with  experienced  computer  users,  this  approach  of 
having  to  address  multiple  menus  again  and  again  Is  an  undesirable  burden  and 
the  preferred  approach  would  be  that  of  minimising  this  Interaction.  Addi¬ 
tionally,  while  It  might  appear  desirable  to  have  a  feature  to  preview  the 
chart  on  the  monitor  prior  to  the  plotting,  to  Incorporate  this  feature  could 
require  substantially  more  complicated  coding  as  well  as  a  hardware  require¬ 
ment  to  include  a  graphics  monitor  as  a  minimum.  The  selected  approach  re¬ 
sulted  in  a  code  design  that  assumed  the  user  to  have  available  a  typical  edi¬ 
tor  /word  processor  program  to  create  a  file  of  information  to  be  processed  hv 
the  PCVUGRAF2  program.  The  only  preview  of  the  final  chart  would  then  be  In 
the  edltor/word  processor  display  on  the  monitor  screen.  There  Is  a  distinct 
advantage  to  the  elimination  of  the  screen  review  In  that  the  plotted  chart  is 
now  In  no  way  related  to  the  ability  to  display  the  chart  on  the  monitor 
screen.  The  chart  is  not  limited  by  eighty  character  lines  or  In  the  case  of 
graphics  screens  the  somewhat  coarse  graphics  of  640  x  200  or  at  best  640  x 
350  resolution.  Additionally  the  typical  twenty-five  lines  per  screen  limit 
of  most  monitors  is  also  avoided  but  at  the  sacrifice  of  not  reallv  knowing 
what  the  chart  is  like  until  it  is  plotted.  Experience  has  shown  the  galni  in 


speed  end  versatility  of  this  approach  outweigh  the  ability  to  preview  the 
chart  before  plotting.  The  selected  approach  allows  for  various  sizes  of  the 
lettering  but  only  the  font  that  is  built  into  the  plotter  being  used.  For 
this  reason  the  newer  Hewlett-Packard  plotters  are  recommended  in  that  the 
built-in  fonts  are  aore  pleasing  to  the  eye  than  the  fonts  in  the  older  mod¬ 
els. 

Within  the  Directed  Energy  Directorate,  the  PCVUGRAF2  program  has  proven 
to  be  a  very  useful  tool  for  generation  of  charts  and  vugrapha  in  a  cost  ef¬ 
fective,  expedient  manner.  The  ability  to  store  the  chart  in  a  disk  file  al¬ 
lows  the  chart  to  be  corrected  or  modified  easily  and  provides  a  convenient 
record  for  future  reference. 

111.  PCVUGRAF2  HARDWARE /SOFTWARE  REQUIREMENTS 

PCVUGRAF2  is  written  in  TURBO-PASCAL  to  Include  the  plotter  Interface  as 
well  as  the  plotting  routines.  Machine  requirements  are  that  of  an  IBM  PC  or 
IBM  PC  compatible  microcomputer  with  a  minimum  of  128K  of  RAM,  MICROSOFT  DISK 
OPERATING  SYSTEM  (MS-DOS),  a  monochrome  or  graphics  monitor  and  a  Hewlett- 
Packard  plotter  (model  7550A  is  typical).  A  line  printer  is  useful  to  allow 
viewing  of  the  entire  file  but  is  not  required.  The  code  has  not  been  checked 
on  all  Hewlett-Packard  plotters  but  appears  to  operate  properly  on  those  tes¬ 
ted.  Additionally  it  is  required  that  an  edltor/word  processor  Is  available. 
To  take  full  advantage  of  the  PCVUGRAF2  program  this  editor  should  not  be  lim¬ 
ited  to  eight  character  lines  but  be  capable  of  up  to  one  hundred  and  sixty 
characters  per  line. 


IV.  PCVUGRAF2  FILE  CREATION 


To  generate  a  chart  using  PCVUGRAF2,  the  user  must  first  create  a  file 
with  the  proper  instructions  and  information  for  the  program  to  process.  This 
information  consists  of  lines  of  code  containing  two  single  character  values 
the  first  of  which  indicates  lettering  size  or  special  feature  and  the  second 
indicating  the  pen  or  alternate  special  features  to  be  used  in  the  plotting  of 
this  current  line  of  data  followed  by  the  text  or  special  information/instruc¬ 
tion  for  this  line  of  data.  The  PCVUGRAF2  program  assumes  the  final  chart  to 
have  a  format  consisting  of  a  TITLE  section  and  a  BODY  section  optionally  con¬ 
tained  within  a  frame.  The  TITLE  section  generally  contains  one  to  three 
lines  of  text  and  is  automatically  horizontally  and  vertically  centered  by  the 
program.  In  this  section  of  the  chart  the  PCVUGRAF2  code  adjusts  the  letter 
size  to  ensure  that  the  intended  information  be  contained  within  the  allotted 
space.  The  BODY  section  of  the  chart  may  contain  up  to  110  lines  of  text.  In 
this  section,  the  code  does  not  automatically  horizontally  center  the  text  but 
allows  the  user  complete  control  over  the  layout  in  this  section.  The  code 
does,  however,  ensure  the  lettering  size  is  adusted  so  that  all  information 
fits  within  the  bounds  in  length  and  height  of  this  section.  The  code  logic 
is  such  that  the  total  number  of  lines  of  code  in  this  section  is  determined 
as  is  the  maximum  number  of  letters  in  the  longest  line.  From  this  informa¬ 
tion,  the  letter  size  is  adjusted  so  that  all  information  will  fit  within  the 
bounds  of  this  area  accounting  for  the  various  sizes  of  letters.  In  both  the 
TITLE  and  BODY  sections  of  the  chart  leading  blanks  are  counted  as  blank  char¬ 
acters,  however,  the  trailing  blanks  are  not  included  in  the  total  character 
count.  The  user  will  find  that  complete  control  in  this  section  sacrifices 
the  code  logic  that  would  automatically  prevent  unpleasant  aspect  ratios  in 
the  lettering.  For  example,  if  only  one  line  of  text  is  indicated  in  the  BODY 
section  of  the  chart  the  code  will  attempt  to  fill  the  entire  BODY  with  this 
single  line  creating  very  tall  lettering.  To  avoid  this  program,  experience 
will  indicate  the  inclusion  of  blank  lines  used  as  spacers  or  space-savers  to 
adjust  the  height  and  width  of  the  lettering.  Figure  1  illustrates  the  gen¬ 
eral  form  of  a  PCVUGRAF2  chart  and  indicates  the  TITLE  and  BODY  sections  en¬ 
closed  in  two  of  the  frame  options  provided  in  the  program.  The  standard  fea¬ 
tures  of  affixing  the  file  name,  current  data,  and  organization  are  also  il¬ 
lustrated  in  this  figure. 

A.  Title  Section 

The  TITLE  section  of  a  chart  typically  contains  from  one  to  three 
lines  of  text.  The  instructions  for  this  section  are  of  the  form: 

SIZE, PEN, TEXT 

where  SIZE  is  a  single  character  representing 
the  relative  size  of  the  line  of  code. 

PEN  is  the  pen  number  to  be  used  in  plotting  the  text, 

TEXT  is  the  string  of  characters  to  be  plotted. 

Note:  The  program  requires  the  SIZE  character  code  to  be  in  column  1  of 

the  card  image  field;  PEN  character  code  in  column  3,  and  the  TEXT  section 
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BODY 


Figure  l .  General  format  of  TITLE  and  BODY  of  PCVUGRAF. 
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beginning  in  column  5.  Each  of  these  sections  is  separated  by  a  comma.  The 
PCVUGRAF2  program  will  raise  an  error  message  if  the  format  of  the  input  is 
violated. 


1.  Size  Options 

Three  options  are  available  for  the  SIZE  parameter  to  determine 
the  relative  size  of  the  lettering  in  each  line.  The  options  are  S,  M,  and  L 
representing  lettering  in  the  relative  size  ratio  of  0.64,  0.80,  and  1.00. 

That  is,  if  on  one  line  large,  L,  lettering  is  used  and  the  next  small,  S,  is 
used,  the  size  of  the  small  lettering  will  be  0.64  of  the  large  lettering 
size.  These  ratios  are  given  as  relative  rather  than  absolute  since  the  ac¬ 
tual  letter  size  will  depend  on  the  number  of  lines  of  text  and  the  maximum 
number  of  letters  in  the  longest  line  in  this  section.  As  previously  stated, 
the  code  automatically  centers  each  line  of  text  in  this  section.  This  cen¬ 
tering  requires  the  counting  of  the  characters  per  line  and  in  so  doing  lead¬ 
ing  blanks  are  included  in  the  total,  trailing  blanks  are  not.  Thus,  common 
practice  is  to  begin  the  line  of  TITLE  text  in  the  first  available  position  in 
the  text  field  to  assure  proper  centering. 

2.  Pen  Options 

The  options  for  PEN  are  dictated  by  the  plotter.  The  model 
7550A,  an  eight  pen  plotter,  will  then  have  eight  options  1 , 2 , 3,4, 5, 6, 7,  and 
8;  the  actual  pen  colors  or  line  widths  will  be  dictated  by  the  placement  in 
the  plotter  carousel. 

3.  Text 

TEXT  represents  the  actual  string  of  characters  to  be  plotted  and 
is  limited  to  160  characters.  A  practical  limit  is  generally  less  than  thirty 
characters  to  assure  the  lettering  size  to  be  in  keeping  with  typical  titles 
and  the  expected  appearance  of  charts  of  this  nature. 

Experience  has  shown  that  three  lines  of  text  in  this  section  is 
a  practical  limit  from  the  appearance  of  the  resulting  chart.  Additionally, 
even  if  only  one  line  of  text  is  desired  it  is  suggested  two  blank  lines  be 
used  to  ensure  a  more  pleasing  appearance  to  the  lettering.  Figure  2  illu¬ 
strates  a  typical  one  line  title;  the  code  to  generate  this  figure  as  well  as 
all  figures  to  follow  is  contained  in  Appendix  A,  note  the  resulting  aspect 
ratio  in  this  section  of  the  chart.  From  the  code  used  in  Figure  2,  it  should 
be  noted  that  the  string  of  dashes  denotes  the  end  of  the  TITLE  section.  Fig¬ 
ure  2  should  be  compared  with  Figure  3  in  which  additional  blank  lines  have 
been  used  to  cosmetically  improve  the  appearance  of  the  TITLE  section  of  the 
chart. 


An  additional  feature  of  this  section  is  that  of  handling  of  pos¬ 
sible  classifications  placed  on  charts  and  vugraphs.  It  is  common  practice  to 
require  that  restricted  information  be  properly  marked.  The  manner  in  which 
this  is  done  is  to  mark  the  chart  both  top  and  bottom  by  information  such  as 
"FOR  OFFICIAL  USE  ONLY".  The  PCVUGRAF2  code  will  automatically  assume  that  if 
the  first  line  of  coded  instruction  in  the  TITLE  section  requires  the  small, 

S,  letter  size,  the  intent  is  that  the  TEXT  will  be  a  classification  marking 
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to  be  placed  on  the  first  and  last  lines  of  the  chart.  Figure  4  illustrates 
the  code  and  resulting  chart  for  this  option.  The  final  user  option  for  the 
TITLE  section  is  not  specified  in  the  generation  of  the  data  file  but  rather 
in  the  running  of  the  PCVUGRAF2  code.  This  option,  to  be  discussed  in  the 
"RUNNING  THE  PROGRAM"  section  determines  the  number  of  times  the  TITLE  section 
is  to  be  overwritten.  Each  time  the  TITLE  is  overwritten  the  pen  is  slightly 
offset  to  add  width  and  boldness  to  the  lettering  thus  enhancing  the  appear¬ 
ance. 

B.  Body  Section 

In  the  data  file  containing  the  information  to  be  processed  by  the 
PCVUGRAPH2  program  the  TITLE  section  is  separated  from  the  BODY  section  by  a 
string  of  dashes.  This  delimiter  will  not  appear  in  the  final  plotted  chart 
but  is  used  within  the  editor  to  allow  the  user  to  easily  see  the  general  form 
and  layout  of  the  chart.  In  this  section  of  the  chart,  additional  options  are 
available  to  allow  not  only  the  three  letter  sizes  but  also  special  charac¬ 
ters,  overlaying,  subscripts,  superscripts,  underlining  and  the  drawing  of 
combinations  of  horizontal  and  vertical  lines  to  form  enclosures  for  tables, 
schedules  and  highlights.  As  in  the  TITLE  section  the  coded  instructions  are 
of  the  form: 

SIZE/ OPTION, PEN/ OPTION, TEXT/ GRAPHICS  INSTRUCTION 
1.  Size  Option 

The  above  form  appears  more  complicated  than  that  previously  dis¬ 
cussed  for  the  TITLE  section.  The  SIZE/OPTION  is  again  a  single  character 
that  specifies  the  letter  size,  S,  M,  or  L  but  in  but  in  addition  has  the  op¬ 
tions  of  T,  B,  0,  and  C  to  indicate  additional  modes  of  operation.  The  first 
character  in  each  line  of  instruction  code  may  be  as  before  S,  M,  or  L  indi¬ 
cating  the  relative  size  of  the  desired  lettering.  The  relative  sizes  are  as 
before  0.64,  0.80,  and  1.00  with  the  absolute  letter  size  determined  by  the 

number  of  lines  of  text  and  the  maximum  number  of  letters  in  the  longest  line. 

For  example,  typical  lines  of  code  may  have  the  form: 

L, 1 , THIS  IS  A  TYPICAL  LINE  OF  LARGE  LETTERING 

S, 2, THIS  IS  A  TYPICAL  LINE  OF  SMALL  LETTERING 

The  SIZE  character  code,  L  and  S  in  the  above  example  must  be  lo¬ 
cated  in  column  1  of  the  card  image;  the  PEN  character  code,  1  and  2  in  the 
above  example,  must  be  located  in  column  3  of  the  card  image,  and  the  TEXT 
section  can  be  located  beginning  in  any  column  from  5  to  160.  These  sections 
of  the  instructions  are  separated  by  commas  as  in  the  TITLE  section. 

The  PCVUGRAF2  program  does  not  automatically  center  text  in  this 
section  of  the  chart  thus  the  relative  positioning  is  up  to  the  user.  In  the 
above  example  the  "T"  in  "THIS"  would  be  at  the  far  left  boundary  of  the  chart 
and  the  final  letter  "G"  in  "LETTERING"  would  be  at  the  far  right  boundary  of 
the  plotting  area  which  might  lead  to  undesirable  aspect  ratios.  Figure  5 
illustrates  the  chart  resulting  from  this  coded  intruction  set  and  the  unde¬ 
sirable  appearance.  As  the  examples  develop,  it  will  become  clearer  how  to 
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avoid  these  problems  but  in  general  it  has  been  found  from  experience  that  a 
minimum  of  approximately  twelve  lines  are  required  in  this  section,  many  of 
which  may  be  blank,  to  achieve  a  reasonable  aspect  ratio  to  the  lettering. 
Figure  6  illustrates  this  improvement. 

2.  First  Character  Options 

The  additional  first  character  options  T,  B,  0,  and  C  indicate 
special  features  that  are  applied  relative  to  a  line  of  code  beginning  with 
the  more  familiar  S,  M,  or  L.  This  is,  a  given  line  of  text  code  plotted 
using  the  S,  M,  or  L  options,  to  be  referred  to  as  the  base  line  in  this  dis¬ 
cussion,  can  be  modified  or  enhanced  by  the  use  of  the  T,  B,  0,  or  C  options. 
The  option  T  indicates  superscript  and  the  B  indicates  a  subscript.  Super¬ 
scripts  and  subscripts  are  of  a  smaller  lettering  size,  relative  size  ratio 
0.50,  and  are  located  slightly  above  or  below  the  base  line  of  text.  An  ex¬ 
ample  of  their  use  is  as  follows  in  which  leading  spaces  have  been  added  with¬ 
in  the  text  to  better  position  within  the  available  area. 

T,5,  2 

L,5,  AREA  »  PI  *  R 

Notice  that  to  exercise  the  superscript  option  or  subscript  op¬ 
tion  two  instruction  code  lines  are  required.  The  ”2"  to  be  used  as  the  su¬ 
perscript  is  located  in  the  column  immediately  to  the  right  of  the  ’’R”  in  the 
base  line  of  CODE.  The  line  of  code: 

L,5,  AREA  “  PI  *  R 

is  the  base  line  of  code  in  the  example.  This  feature  is  illustrated  in  Fig¬ 
ure  7 . 


3.  Overlay  Option 

The  0  or  overlay  option  is  to  allow  the  use  of  different  pens  to 
write  lettering  on  a  single  line  of  text.  This  option  might  be  used  to  high¬ 
light  a  word  or  phrase  within  a  line  by  writing  over  a  given  word  a  second 
time  to  make  it  somewhat  darker  than  the  surrounding  text  or  to  use  an  alter¬ 
nate  pen  to  insert  a  highlighted  word  or  phrase  within  the  line.  The  fol¬ 
lowing  example  illustrates  the  code  to  insert  a  word  written  with  an  alternate 
pen  within  the  base  line  of  code;  see  Figure  8. 

L, 1 ,THE  BASE  LINE  HAS  A  IN  IT 

0,5,  HIGHLIGHT 

It  is  assumed  the  pen  number  5  is  somehow  different  from  pen  num¬ 
ber  1  such  as  being  wider  or  of  an  alternate  color.  The  overlay,  0,  option 
can  be  used  with  any  letter  size,  S,  M,  or  L  and  the  overlayed  text  will  be 
sized  according  to  the  base  line  of  code  directly  above  it  in  the  above  ex¬ 
ample.  Multiple  overlays  are  possible  to  provide  the  use  of  several  different 
colors  of  pens  on  a  single  line  as  in  the  following  example. 


L,l,  BLACK  PEN  H 

0,2,  RED  PEN  #2 

0,3,  GREEN  PEN  #3 

4.  Special  Character  Option 

The  special  character  or  C  option  provides  for  characters  and 
symbols  not  normally  available  within  the  built-in  character  set  of  the  plot¬ 
ter.  These  characters  are  currently  limited  to  mathematical  and  typical  Greek 
symbols  used  in  science  and  engineering.  The  manner  in  which  the  special 
character  option  is  used  is  to  so  signify  by  the  first  letter  of  the  instruc¬ 
tion  code  beginning  with  "C"  followed  by  the  pen  number  to  be  used.  The  text 
section  will  be  interpreted  as  special  character  code  rather  than  the  normally 
represented  ASCII  character.  Table  1  lists  the  special  character  codes  and 
the  corresponding  special  character.  For  example,  the  letter  "p"  is  used  to 
Indicate  the  desired  use  of  the  greek  letter  it.  The  special  character  option 
is  used  in  a  manner  simular  to  the  overlay  option  in  that  it  is  assumed  by  the 
program  the  special  character  is  to  be  inserted  or  overlayed  within  a  base 
line  of  code  that  preceeds  it  and  thus  determines  the  actual  letter  size.  An 
example  of  the  use  of  this  option  is: 

T,l,  2 

L,l,  AREA  -  *  R 

C,l,  P 


Figure  9  illustrates  the  resulting  chart  from  this  set  of  instructional  code. 
For  those  cases  in  which  the  special  character  is  not  to  be  inserted  within  a 
line  of  text  but  is  to  be  a  separate  line  of  text,  the  approach  would  be  to 
create  a  blank  base  line  into  which  the  special  character  would  then  be  in¬ 
serted. 


5.  Pen  Option 


The  Pen/Option  character  code  not  only  provides  the  pen  number  to 
be  used  in  plotting  the  text  but  also  provides  two  additional  options  in  this 
section.  The  underline  option,  U,  provides  a  mechanism  to  under  line  a  por¬ 
tion  of  a  line  of  text.  This  option  is  used  much  like  the  modification  and 
enhancement  options  previously  discussed.  An  example  of  its  use  is: 


L,5, 


THIS  IS  AN  EXAMPLE  OF  THE  UNDERLINE 


S.U, 


where  the  character  is  used  to  indicate  the  underlining  option,  see  Figure  10. 


The  graphics  option  provides  the  ability  to  draw  limited  graph¬ 
ics.  These  graphics  are  limited  to  horizontal  and  vertical  lines  between  end 
points  specified  by  the  user.  The  coding  used  is  to  denote  the  use  of  this 
option  by  specification  of  "S,G,"  as  the  code.  The  TEXT  section  of  the  line 


.  .W  -N  V,W. 
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TITLE 


A 


THIS  IS  A  TYPICAL  LINE  OF  LAR6E  LETTERIN6 

THIS  IS  A  TYPICAL  LINE  OF  SMALL  LETTERING 


Figure  6 .  Reasonable  aspect  ratio  in 

the  lettering  of  the  chart. 
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TITLE 


W  Kff — | 


AREA  =  PI  *  Ra 


.  A  Q  10  U 


THE  BASE  LINE  HAS  A  HIGHLIGHT  IN  IT 


Figure  8.  Overlay  option. 


TABLE  1.  Special  Character  Codes 


CODE 


SPECIAL  CHARACTER  COOES 


CHARACTER 


CODE 


CHARACTER 


TITLE 


AREA  - 


Figure  9. 


icial  character  option. 


TITLE 


THIS  IS  AN  EXAMPLE  OF  THE 


Figure  10.  Underline  feature. 


of  cod*  it  replaced  by  the  tingle  character  lettera  T,  B,  L,  R,  an  ♦  .  The 
character  T  denotea  the  upper  extreme  of  a  vertical  line  to  be  drawn  between  T 
and  B  where  B  denote*  the  lower  extreme.  Likewise  L  and  R  are  the  extreaMS, 
left  and  right,  of  a  horixontal  line.  Placement  of  thea*  tinea  within  the 
normal  text  will  allow  the  text  to  be  aeparated  by  horixontal  and  vertical 
line*.  An  example  of  ita  uae  it  aa  below: 


S,G,L  T  T 

L, 1,  TECHNICAL  AREA  FUNDS  AVAILABLE  COST  TO  DATE 

S,G,L 


HARDWARE 


$10,000. 


$3,000. 


S,  C,  L 


M,  l ,  SOFTWARE 


$  9,000. 


$5,000. 


S,  C,  L  B  B  R 

Figure  11  illuatratea  the  reaulting  chart.  The  appearance  of  the  chart  would 

be  improved  if  the  text  waa  encloaed  within  a  box  rather  than  only  the  hori¬ 

xontal  and  vertical  linea.  The  character  ia  uaed  to  accomplish  this.  The 
locates  a  corner  and  requires  second  graphics  character,  L,  R  or  ♦  to  be 
located  on  the  tame  horixontal  line  and  another  in  the  same  vertical  column  to 
complete  the  definition  of  the  corner.  This  ia  best  seen  by  example;  the  pre¬ 
vious  example  is  repeated  as  follows: 

S,G,*  T  T  ♦ 

L, 1,  TECHNICAL  AREA  FUNDS  AVAILABLE  COST  TO  DATE 

S,G,L  R 


H,  1 ,  HARDWARE 


$10,000. 


$3,000. 


S,G,L 


M,  I ,  SOFTWARE 


$  9,000. 


$5,000. 


S,  G,  ♦ 


Figure  12  illustrates  the  chart  resulting  from  these  instructions.  The  graph¬ 
ics  option  requires  the  uae  of  pairs  of  symbols  to  define  the  beginning  and 
terminating  locations  of  horixontal  and  vertical  lines.  These  symbols  must  be 
properly  aligned  in  the  instruction  file  and  failure  to  do  so  will  cause  the 
program  to  accomodate  the  symbol  as  to  providing  adequate  space  to  perform  the 
graphics  but  will  not  actually  draw  the  lines  unless  the  pairing  is  accom¬ 
plished.  That  is,  the  code  matches  only  vertical  and  horizontal  end  points, 
if  the  end  points  do  not  align  themselves  properly  it  will  be  interpreted  as 
single  end  points  of  different  lines  rather  than  end  points  of  the  same  line. 
Since  trailing  blanks  are  not  used  to  determine  the  maximum  tine  length,  no 


Figure  11.  Vertical  and  horizontal  line  features, 


■mbi  has  baan  discussed  to  this  point  to  forca  tha  placaaant  of  short  lines 
of  text  to  tha  laft  portion  of  tha  chart.  A  convenient  aeans  of  accoapllshlng 
this  is  to  provide  a  final  line  of  test  ualng  tha  graphics  option  with  "1"  In 
tha  eoluaa  to  daflaa  tha  right  aost  boundary  of  tha  chart.  To  Illustrate 
this,  coapare  figures  13  and  U  and  the  corresponding  coding  used  to  create 
than.  An  additional  option  Is  provldad  for  drawing  horizontal  llnas.  This 
option  Is  of  tha  fora: 

L.l.  - 

This  eoaaand  results  In  drawing  a  horizontal  line  hetveen  the  estreaas.  If  a 
single  hyphen  is  used  It  is  interpreted  as  a  normal  hyphen.  Multiple  hyphens 
are  Interpreted  as  a  continuous  line.  This  option  thus  aakes  the  noraal  plot* 
ting  of  a  string  of  hyphens  iapoeslble,  however,  this  Is  provided  as  a  special 
character  feature.  The  Instruction: 

c.i, - 

will  result  In  a  hyphen  string.  The  Appendixes  contains  exaaples  of  the  use 
of  these  two  features. 

The  preceedlng  discussion  has  described  the  options  available  In  the 
PCVUCRAF2  prograa.  The  user  can  coabine  these  features  to  construct  charts 
and  vugraphs  of  various  types  and  foras.  Typical  exaaples  of  charts  and  vu- 
graphs  are  found  In  both  Appendixes  of  this  report. 


Figure  !■».  Graphic  option  to  center  text  in  chart. 


V.  GENERATING  A  CHART/ VUG RAPH 


A*  Preparation 

Paragraph  B,  "Running  The  Program",  describes  user  input  necessary  for 
the  coda  to  ganarata  a  chart  or  vugraph.  This  input  specifies  the  date,  or¬ 
ganisation,  disk  drive  containing  the  chart  files,  heaviness  of  the  title  sec¬ 
tion,  fraaw  style,  chart  size,  and  pen  speed.  A  configuration  file  is  pro¬ 
vided  to  provide  default  values  for  each  of  these  parasmters  so  that  rather 
than  entering  the  values  each  time  the  code  is  run,  the  user  can  simply  strike 
the  enter  key  to  use  values  contained  in  the  configuration  file.  The  config¬ 
uration  file  is  named  VG.CFG  and  has  the  form: 

C0M1  {where  is  the  plotter?  coml  or  com2} 

2400  {baud  rate:  300,  1200,  2400  etc.  } 


AMSMI-RO-DE-TS  {your  organization  } 
B:*.VG  {where  to  look  for  files  } 
MEDIUM  {LIGHT,  MEDIUM  or  HEAVY  } 
FRAME  {FRAME,  CHART,  BCHART  or  NONE  } 
1.0  {chart  size:  0.S  to  1.0  } 
10  {pen  speed:  i  -  35  } 


Most  of  these  input  paraamters  are  self-evident.  The  third  of  the  values  in  a 
character  string  that  specifies  the  organization  or  other  code  specifying  the 
origin  of  the  chart.  This  input  is  limited  to  15  characters.  The  input  spe¬ 
cified  as  "MEDIUM"  determines  the  darkness  of  the  title  section  of  the  chart. 
Four  options  are  available  to  specify  the  type  frame  used  in  the  final  chart. 
FRAME  specifies  the  rounded  corner  frame  typical  of  vu-graphs.  CHART  is  the 
box  style  typically  8  x  10  inches.  BCHART  is  a  larger  box  that  requires  lar¬ 
ger  paper  11  x  17  inches.  The  input  with  the  value  "1.0"  is  the  size  of  the 
resulting  chart  with  a  value  1.0  specifying  full  size  chart  of  sufficient  size 
to  occupy  a  typical  8  x  10  inch  sheet  of  paper  or  if  the  BCHART  option  is  used 
to  fill  an  area  of  approximately  11  x  17  inches.  To  reduce  the  size  of  the 
final  chart  values  less  than  1.0  are  used. 

B.  Running  the  Program 

The  program  is  initiated  by  typing  the  program  name,  PCVUGRAF,  immedi¬ 
ately  following  the  operating  system  prompt.  The  program  then  prompts  the 
user  for  affirmation  of  the  date: 


system  date  Is  1  Apr  1986 


eater  plotdate  or  cr 


The  indicated  date,  in  this  case  1  Apr  1986,  will  be  affixed  to  each 
chart  generated.  If  the  user  desires  an  alternate  date,  it  should  be  entered 
at  this  point. 

The  second  prompt  is  in  the  form: 

organizational  symbol  is  AMSMI-RD-DE-TS 

enter  change  or  cr 

The  indicated  organizational  symbol  will  be  affixed  to  the  resulting 
chart;  the  user  has  the  opportunity  to  change  the  default  value  at  this  point. 

The  user  is  next  prompted  to  specify  or  select  the  chart  instruction 
files  to  be  processed.  These  are  the  files  previously  generated  containing 
the  instructions  and  text  associated  with  the  chart  to  be  generated.  This 
prompt  is  in  the  form: 

to  select  files  for  plotting 
Enter  the  drive 
enter  the  directory 
enter  the  file  template  —  example 
*.vug 
— > 

The  user  should  enter  the  disk  drive,  directory  if  appropriate  and 
template  as  desired.  As  an  example,  if  the  files  were  contained  on  a  disk  lo¬ 
cated  on  drive  B  the  user  would  enter: 

Bt 

The  program  would  then  list  all  files  contained  on  this  disk  for  the 
user  to  select  from.  If  the  only  files  to  be  considered  were  known  to  end  in 
".vug",  the  user  might  enter 

B:*.vug 

to  only  list  files  on  the  B  drive  ending  in  .vug. 

Having  specified  the  location  of  the  files  and  any  template,  the  code 
will  list  the  indicated  files  in  the  form: 


Move  w /  arrows,  select  w/  {Return),  done  w/  *Da,  abort  w /  'A* 


FI6URE12.VUG 
FIGURE13. VU6 
FI0URE14.VU6 
SCHEDULE.  VIE 
BULLET. VUG 


FIGURE!. VUG 
FI6URE2.WG 
FIGURE3.VU6 
O0O1.VUB 
FIGURED  VUG 
V6TITLE.VU6 
DEM0R.VU6 
LPCVU6RA.VU6 
FIGURE!  VUG 
LRVUGRflF. VUG 
FIGURES.  VIE 
DEND2.VU6 
FIGURE7.  VUG 
TITLE.  VUG 
FIGURES. VUG 
TITLE1.VIE 
FIGURE!  VU6 
FIGURE18.VU6 
FIGURE11.VU6 


The  next  step  is  to  indicate  which  files  are  to  be  processed  by  the  PCVUGRAF2 
program.  This  is  accomplished  by  moving  the  cursor  with  the  cursor  keys  or 
arrow  keys  either  up  or  down  until  it  lies  next  to  the  file  desired.  The  file 
is  then  selected  and  marked  as  such  by  use  of  the  ENTER  or  RETURN  key.  The 
screen  will  Indicate  this  by  placing  an  asterlck  to  the  right  of  the  selected 
file  as  Illustrated  below. 


Rove  w /  arrows,  select  w/  {Return),  done  w /  *D*,  abort  w /  *A" 
FI6URE1.VU6  FI SURE 12. VUG 

FIGURE2.VU6  FIGURE  13,  VUG 

FIGURE3.VU6  FIGURE 14. VUG 

DOE  1.  VUG  >  SCHEDULE.  VUG 

FIGURE4.  VUB  BULLET.  WG 


^V>V-\V.n\  %V-V' 


*  V  %  •, 


'W' 


The  user  can  specify  as  many  as  thirty  files  to  process.  If  the 
plotter  in  use  has  the  features  of  automatic  page  feed,  the  model  7550A  for 
example,  each  of  the  selected  charts  will  be  processed  automatically  without 
operator  intervention.  If  a  plotter  such  as  the  model  7475A  is  used  which 

does  not  have  automatic  page  feed,  the  user  will  be  prompted  at  the  appropri¬ 

ate  time  to  change  paper.  This  does  allow  a  que  of  files  to  be  processed 
without  rerunning  the  PCVUGRAF2  code  for  each  chart. 

Once  all  the  charts  to  be  processed  are  specified,  the  user  so  indi¬ 
cates  by  entering  "d“  or  "D"  for  “done".  It  is  not  necessary  to  follow  the 

"d"  with  an  ENTER.  If  for  any  reason  the  wrong  drive  or  directory  was  selec¬ 
ted,  it  is  not  necessary  to  "quit"  and  restart;  simply  indicate  "done"  and  the 
next  menu  will  allow  the  user  to  make  the  proper  choices  by  repeating  the 
above  menu . 

The  next  prompt  confirming  the  selection  of  files  is  in  the  form: 
enter  Q  to  quit,  R  to  reselect,  return  to  plot 

If  the  files  have  been  appropriately  selected,  then  indicate  so  by 
the  ENTER  or  RETURN  key. 

The  code  will  proceed  to  process  all  files  previously  selected.  The 
code  will  display  on  the  screen  three  windows  that  will  remain  for  the  dura¬ 
tion  of  the  processing.  The  second  and  third  of  the  windows  are  dynamic  and 
will  monitor  the  progress  of  the  program.  The  middle  box  contains  the  data 
file  currently  being  processed,  the  specified  options  which  will  be  discussed 
in  the  following  section,  and  a  dynamic  indicator  of  the  processing  through 
the  contents  of  both  the  plotter  instruction  buffer  and  a  code  buffer.  This 
report  will  not  discuss  the  details  of  these  buffers  but  will  indicate  the 
buffers  are  used  to  interface  the  code  with  the  plotter  hardware.  The  code 
monitors  the  contents  of  both  buffers  and  reports  its  findings  In  the  form: 

0133  »»»»»»»»»»»»»»> 

795  <<<<<<<<<<<<<<<<<<<<<< 

The  first  line  indicates  the  available  space  in  the  plotter  buffer 
both  numerically  in  bytes,  133  in  the  above  example,  and  graphically  as  the 
length  of  the  string  of  ">"  or  ”<”.  The  length  of  the  string  indicates  the 
"fullness"  of  the  buffer.  The  final  or  lower  window  displays  the  lines  of 
code  as  they  are  processed  and  indicate  any  errors  that  may  occur. 

To  complete  the  specification  of  the  final  chart,  the  user  must  spe¬ 
cify  four  additional  parameter  values,  the  number  of  times  the  title  is  to  be 
overwritten,  the  border  style  or  frame  to  be  used,  the  relative  size  of  the 
chart,  and  the  pen  speed  used  in  the  plotting.  The  user  will  be  prompted  in 
the  form: 


PC-VIEU-6RAPH 
by  Niles  Holloean  and  Uilliaa  Otto 


prog 

filename 

line 

style 

size  speed 

V6  vl.ld 

B:DEN01.VU6 

10:23 

7  Nay  I960 

1024 

with  the  cursor  located  under  the  heading  "line".  "Line"  indicates  the  number 
of  times  the  TITLE  section  is  overwritten.  Three  options  are  available: 

LI  -  Light  -  only  written  once 

ME  -  Medium  -  written  twice 

HE  -  Heavy  -  written  four  times 

The  default  for  this  option  is  contained  in  the  VG.CFG  file  and  may 
be  selected  by  striking  the  ENTER  key.  If  any  one  of  the  other  options  is 
desired,  it  is  selected  at  this  time. 

The  user  having  selected  the  "line"  option,  the  cursor  moves  to  the 
"style"  heading  for  selection  of  the  style  frame  to  be  used.  Three  options 
are  available; 

FRAME  -  Vu-graph  frame  indicated  in  Figure  1 
CHART  -  Box  style  frame  indicated  in  Figure  1 
BCHART  -  Large  box  style 
NONE  -  No  frame 

The  default  value  is  contained  in  the  VG.CFG  file. 


.-W  v?.-  ■ 


V-'v.V.  ' 


The  size  option  may  take  any  positive  value  with  a  maximum  value  of 
1.0.  Generally  values  are  in  the  range  0.4  -  1.0.  Again  the  default  value  is 
contained  in  the  VG.CFG  file. 

The  final  option  is  for  the  pen  speed.  It  has  been  found  that  in 
general  a  pen  speed  of  10  cm/sec  is  adequate  for  inking  of  the  paper  for  most 
charts.  Faster  pen  speeds  provide  the  finished  charts  quicker  at  a  possible 
sacrifice  in  inking,  slower  speeds  may  be  required  for  proper  inking  of  trans¬ 
parency  materials. 

Once  these  three  options  are  specified,  the  program  processes  the 
charts  in  order.  The  middle  and  lower  windows  will  monitor  the  progress  of 
the  program  by  indicating  the  file  name  of  the  chart  being  processed  number  of 
lines  of  code  length  of  the  longest  line  and  the  buffer  status  in  the  middle 
window.  The  lower  window  will  monitor  the  lines  of  code  being  processed  by 
displaying  the  line  number  and  the  actual  line  of  code.  The  following  example 
is  typical  of  the  screen  display  during  processing. 


PC-VIEW-6RAPH 
by  Miles  Holloaan  and  Uilliaa  Otto 
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7  Nay  1986 

e 


The  program  terminates  and  returns  to  the  operating  system  at  the 
completion  of  the  processing  of  all  files.  The  screen  appears  as  below  at 
program  termination. 
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PC-VIEW-6RAPH 
by  Niles  Holloaan  and  Uilliaa  Otto 
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67  lines 
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ELAPSED  TINE  *  3  ein  56  sec 
TflL  ELAPSED  TINE  -  4  ein  5  sec 
HAVE  A  6  0  0  D  DAY 
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APPENDIX  A 

Codes  To  Generate 
Figures  2  Through  14 
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APPENDIX  A 


This  appendix  contains  ths  cods  used  to  gsnsratc  Figures  2 
Figure  2  ~ 

L, 5, TITLE 


Figure  3  - 
L,5, 

L, 5, TITLE 
L»5, 


Figure  4  - 

S,5,F0R  OFFICIAL  USE  ONLY 

L, 5, TITLE 

L,5, 


Figure  5  - 

S,5, 

L,5,TITLE 

L,5, 


L, 5, THIS  IS  A  TYPICAL  LINE  OF  LARGE  LETTERING 

S, 5, THIS  IS  A  TYPICAL  LINE  OF  SMALL  LETTERING 
Figure  6  - 
S»5, 


L, 5, TITLE 


t* 

t*l 


\ 


> 

I 

i 


L,5, 
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APPENDIX  B 


Three  example  charts  and  their  respective  instruction  files  are  contained 
in  this  appendix  to  serve  as  templets  and  guides  to  the  more  used  chart  forms. 

Figure  B-l  illustrates  a  typical  "Bullet  Chart”  in  which  the  special 
character  bullet  is  used  to  highlight  portions  of  a  chart. 
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Figure  B-l .  Bullet  chart. 
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